home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / Chip_2004-11_cd1.bin / zkuste / planetaria / download / celestia / celestia-win32-1.3.2.exe / {app} / README.txt < prev    next >
Text File  |  2004-08-21  |  19KB  |  444 lines
  1. ***************************************************************************
  2. *                                 Celestia                                *
  3. *                                                                         *
  4. *  A real-time space simulation that lets you experience our universe in  *
  5. *  three dimensions.                                                      *
  6. *                                                                         *
  7. *                    Copyright (c)2001-2004, Chris Laurel                 *
  8. *                           <claurel@shatters.net>                        *
  9. *                                                                         *
  10. *-------------------------------------------------------------------------*
  11. *  Celestia web site: http://www.shatters.net/celestia/                   *
  12. *                                                                         *
  13. *  Celestia documentation:                                                *
  14. *    http://www.shatters.net/celestia/documentation.html                  *
  15. *                                                                         *
  16. *  Celestia forums: http://www.shatters.net/forum/                        *
  17. ***************************************************************************
  18.  
  19. CONTENTS
  20. --------
  21.   License
  22.   Installing in Unix
  23.   Getting Started
  24.   Mouse, Keyboard & Joystick Controls
  25.   Solar System Browser
  26.   Star Browser
  27.   Selecting Objects by Name
  28.   Known Issues
  29.   User Modifiable Elements
  30.   Celestia Resources
  31.   Credits
  32.  
  33.  
  34. LICENSE
  35. -------
  36. This program is free software; you can redistribute it and/or modify it under
  37. the terms of the GNU General Public License as published by the Free Software
  38. Foundation; either version 2 of the License, or (at your option) any later
  39. version.
  40.  
  41. This program is distributed in the hope that it will be useful, but WITHOUT
  42. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  43. FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  44. details, which you should have received along with this program (filename:
  45. COPYING).  If not, request a copy from:
  46.   Free Software Foundation, Inc.
  47.   59 Temple Place - Suite 330
  48.   Boston, MA  02111-1307
  49.   USA
  50.  
  51.  
  52. INSTALLING IN UNIX
  53. ------------------
  54. Type "./configure --help" for a list of options.  The basic commands are shown
  55. below.  For more detailed information, refer to the INSTALL file.
  56.  
  57. This GTK version is built with...
  58.   ./configure --with-gtk
  59.   make
  60.   make install
  61.  
  62. The KDE3 version is built with...
  63.   ./configure --with-kde
  64.   make
  65.   make install
  66.  
  67. The Gnome version is built with...
  68.   ./configure --with-gnome
  69.   make
  70.   make install
  71.  
  72. If all else fails, try the gui-less version with...
  73.   ./configure --with-glut
  74.   make
  75.   make install
  76.  
  77.  
  78. GETTING STARTED
  79. ---------------
  80. Celestia will start up in a window, and if everything is working correctly,
  81. you'll see Earth in front of a field of stars.  Displayed on-screen, is some
  82. information about your target (Earth), your speed, and the current time
  83. (Universal Time, so it'll probably be a few hours off from your computer's
  84. clock).
  85.  
  86. Right drag the mouse to orbit Earth and you might see the Moon and some
  87. familiar constellations.  Left dragging the mouse changes your orientation
  88. also, but the camera rotates about its center instead of rotating around
  89. Earth.  Rolling the mouse wheel will change your distance to Earth--you can
  90. move light years away, then roll the wheel in the opposite direction to get
  91. back to your starting location.  If your mouse lacks a wheel, you can use the
  92. Home and End keys instead.
  93.  
  94. When running Celestia, you will usually have some object selected.  Currently,
  95. it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some
  96. other object.  The simplest way to select an object is to click on it.  Try
  97. clicking on a star to select it.  The information about Earth is replaced with
  98. some details about the star.  Press G (or use the Navigation menu), and you'll
  99. zoom through space toward the selected star.  If you press G again, you'll
  100. approach the star even closer.
  101.  
  102. Press H to select our Sun, and then G to go back to our Sun.  Right click on
  103. the sun to bring up a menu of planets and other objects in the solar system. 
  104. After selecting a planet from the menu, hit G again to travel toward it.  Once
  105. there, hold down the right mouse button and drag to orbit the planet.
  106.  
  107. The Tour Guide is a list of some of the more interesting objects you can visit
  108. in Celestia.  Select the Tour Guide option in the Navigation menu to display
  109. the Tour Guide window.  Choose a destination from the list, click the Goto
  110. button, and you're off.
  111.  
  112. That covers the very basics.  For a more in-depth look at Celestia and the
  113. controls available to you, download the "Celestia User's Guide" (written by 
  114. Frank Gregorio), available in several languages, from:
  115.   http://www.shatters.net/celestia/documentation.html
  116. This web page also includes links to the Celestia README file translated into
  117. Japanese.
  118.  
  119.  
  120. MOUSE, KEYBOARD & JOYSTICK CONTROLS
  121. -----------------------------------
  122. See the included file: KbdMouseJoyControls.txt.  In Windows, you can also use
  123. the Help menu to display the Controls list.
  124.  
  125.  
  126. SOLAR SYSTEM BROWSER (Windows version only)
  127. -------------------------------------------
  128. The Navigation menu contains 'Solar System Browser' and 'Star Browser'
  129. options.  The Solar System Browser displays a window with a tree view of all
  130. the objects in the nearest solar system (if there is one within a light year
  131. of your current position.)  Clicking on the name of any object in the window
  132. will select it.  You can then use the Center or Go To buttons to display that
  133. object in the main Celestia window.
  134.  
  135.  
  136. STAR BROWSER (Windows version only)
  137. -----------------------------------
  138. By default, the Star Browser window displays a table of the 100 nearest stars,
  139. along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking
  140. on the column headers will sort the stars.  The table is not continuously
  141. updated, so if you travel to another star, you should press the Refresh button
  142. to update the table for your current position.  The radio buttons beneath the
  143. table let you switch between viewing a list of Nearest, Brightest, or 'With
  144. planets' stars.  As with the solar system browser, clicking on any star name
  145. in the table will select it.  Use this feature along with the Center and Go
  146. To buttons to tour the stars visible from any night sky in the galaxy.
  147.  
  148.  
  149. SELECTING OBJECTS BY NAME
  150. -------------------------
  151. Celestia provides several ways to select an object by name...
  152.   1. Choose 'Select Object' from the Navigation menu, type in the object
  153.      name, and click OK.
  154.  
  155.   2. Press Enter, type in the entire object name, and press Enter again.
  156.  
  157.   3. Press Enter, type in the first few characters of the object name,
  158.      press the Tab key to move through the displayed listing until the
  159.      object is highlighted, then press Enter again.
  160.  
  161. You can use common names, Bayer designations, or HD catalog numbers for
  162. stars.  HD catalog numbers must be entered with a space between HD and the
  163. number.  Celestia handles star catalog numbers in a slightly kludgy way, to
  164. keep the star database size to minimum -- only one catalog number is stored.
  165. Normally, this will be a number from the HD catalog, but if a star isn't in
  166. the HD catalog the number from another catalog will be used instead.
  167. Currently, the secondary catalog is always the HIPPARCOS data set, for which
  168. the prefix "HIP" should be used.
  169.  
  170.  
  171. KNOWN ISSUES
  172. ------------
  173. Many people have reported problems running Celestia with Matrox G400/G450 3D
  174. accelerator cards.  As I don't have a Matrox card, I haven't made much
  175. progress on this bug.  If you do have a G400, have Visual C++ installed, and
  176. would be interested in testing a debug version of Celestia, please contact me.
  177.  
  178. The maximum texture size supported by the Voodoo 1/2/3 is 256x256, so many of
  179. the planet textures will look blurry when running Celestia on one of these
  180. cards.
  181.  
  182. On 3D accelerator cards with a limited amount of memory, resizing the main
  183. Celestia window can cause textures to disappear.  This occurs because so much
  184. memory is required for the frame buffer that there's not enough left for
  185. textures.  There are a several workarounds:
  186.   - Use a smaller window
  187.   - Make sure your display is set to 16-bit (high color) mode
  188.   - Try running Celestia in full screen mode
  189.  
  190. Celestia only barely works in 256 color mode.  If your display is set to 256
  191. colors, change it to 16-bit or 32-bit if at all possible.
  192.  
  193. If objects look good at a distance but get too dark when you approach them
  194. closely, your OpenGL driver does not support a required extension.  Try
  195. upgrading to the most current version of drivers available for your card.  For
  196. some older cards, this still won't fix the problem.  The next version of
  197. Celestia will feature a workaround.
  198.  
  199. For up-to-the-minute answers to some common problems encountered when running
  200. Celestia, please view the "preliminary Celestia User's FAQ" located on the
  201. Celestia User's Forum:
  202.   http://www.shatters.net/forum/viewtopic.php?t=2291
  203.  
  204.  
  205. USER MODIFIABLE ELEMENTS
  206. ------------------------
  207. You can modify how Celestia starts up each time you run it, by defining your
  208. own start-up settings.  Simply open the file "start.cel" in a plain text
  209. editor and follow the in-file instructions.  Also, view the celestia.cfg file
  210. in a plain text editor to see additional settings.
  211.  
  212. Celestia allows you to create an entirely fictional universe, by modifying its
  213. solarsys.ssc, stars.dat, and hdnames.dat files.  The easiest file to modify is
  214. the solar system catalog (solarsys.ssc), since it's a plain text file and the
  215. format is very text-editor friendly.  It's also quite verbose, but that's not
  216. a problem yet.
  217.  
  218. The units used for the solar system data may not be obvious.  All angle fields
  219. in the catalog are in degrees.  For planets, the period is specified in earth
  220. years, and the semi-major axis in AU; for satellites, days and kilometers are
  221. used instead.
  222.  
  223. When adding objects, they should be included in their own sub-directory under
  224. Celestia's "extras" directory.  For example:
  225.   celestia <dir>
  226.     extras <dir>
  227.       yourNewObject <dir>
  228.         about.txt
  229.         install.txt
  230.         object.dsc
  231.         object.ssc
  232.         object.stc
  233.         models <dir>
  234.           object.3ds
  235.           object.cmod
  236.           object.cms
  237.         textures <dir>
  238.           medres <dir>
  239.             objectTexture.??? (jpg, png, dds, or bmp)
  240.  
  241. YOU create each of the directories under the extras directory.  By using this
  242. structure, activating and de-activating your new objects will be easy.  Simply
  243. move the sub-directory "yourNewObject" outside of the extras directory.  Some
  244. users have found that adding category-name sub-directories under extras to be
  245. useful, such as:
  246.   celestia
  247.     extras
  248.       Deep Sky Objects
  249.         yourNewObject
  250.       Galaxies
  251.         yourNewObject
  252.       Spacecraft
  253.         yourNewObject
  254.  
  255. Texture files should be placed in textures/medres, as shown above.  Currently,
  256. JPEG, PNG, BMP, and DDS are the only formats supported.
  257.  
  258. Models belong in the models directory.  Celestia can read 3DS models, and two
  259. custom formats (.cms and .cmod).  The .cms files are currently used for rough
  260. fractal displacement map likenesses of asteroids and small moons.  3DS meshes
  261. are normalized to fit within a unit cube -- the Radius field determines how
  262. big they appear within Celestia.
  263.  
  264. The stars.dat file is a binary database of stars, processed from the 50+ meg
  265. HIPPARCOS data set.  The first four bytes are an integer (int) value
  266. containing the number of stars in the database.  Following that are a bunch of
  267. records of this form:
  268.   4 byte int   : catalog number
  269.   4 byte float : right ascension
  270.   4 byte float : declination
  271.   4 byte float : parallax
  272.   2 byte int   : apparent magnitude
  273.   2 byte int   : stellar class
  274.   1 byte       : parallax error
  275.  
  276. RA, declination, and parallax are converted to x, y, z coordinates, and
  277. apparent magnitude is converted to absolute magnitude when the database is
  278. read.
  279.  
  280. For more detailed information about creating add-ons for Celestia, please
  281. visit Selden's "Introduction to Celestia Add-ons" web page at:
  282.   http://www.lns.cornell.edu/~seb/celestia/addon-intro.html
  283.  
  284.  
  285. CELESTIA RESOURCES
  286. ------------------
  287. Celestia Web Site:
  288.   http://www.shatters.net/celestia/
  289.  
  290. Celestia User Forums:
  291.   http://www.shatters.net/forum/
  292.  
  293. Selden's List of Resources for Celestia :
  294.   http://www.lepp.cornell.edu/~seb/celestia/
  295.  
  296. Celestia Source Code (SourceForge.net):
  297.   http://sourceforge.net/projects/celestia/
  298.  
  299.  
  300. CREDITS
  301. -------
  302.  
  303. Authors
  304. -------
  305.   See the AUTHORS file
  306.  
  307. Contributors
  308. ------------
  309.   Deon Ramsey ........... UNIX installer, GTK interface
  310.   Christopher ANDRE ..... Eclipse Finder
  311.   Colin Walters ......... Endianness fixes
  312.   Peter Chapman ......... Orbit path rendering changes
  313.   James Holmes ..........
  314.  
  315. Documentation
  316. -------------
  317.   Frank Gregorio ........ Celestia User's Guide
  318.   Hitoshi Suzuki ........ Japanese README translation
  319.   Christophe Teyssier ... DocBook and HTML conversion of User's Guide
  320.   Diego Rodriguez ....... Acrobat conversion of User's Guide
  321.   Don Goyette ........... CEL Scripting Guide
  322.   Harald Schmidt ........ Celx/Lua Scripting Guide
  323.  
  324.  
  325. Other Contributors
  326. ------------------
  327. Models of Mars Global Surveyor and Mars Odyssey were created by Shrox:
  328.   http://www.shrox.com/
  329. The Cassini and Huygens models are by Jack Higgins:
  330.   http://homepage.eircom.net/~jackcelestia/
  331.  
  332. Most of the planet maps are from David Seal's site:
  333.   http://maps.jpl.nasa.gov/.
  334. A few of these maps were modified by me, with fictional terrain added to fill
  335. in gaps.  The model of the Galileo spacecraft is also from David Seal's site
  336. (though it was converted from Inventor to 3DS format.)
  337.  
  338. The Mars, Neptune, and Uranus textures and Mars, Moon and Mercury bump maps are
  339. all from James Hastings-Trew's collection, and the Mercury texture is a recolored 
  340. version of his. Some of the prettiest planet maps around are at: 
  341.   http://gw.marketingden.com/planets/planets.html
  342.  
  343. Fridger Schrempp produced the 'available data' Pluto and Charon textures using
  344. maps created by Marc Buie at Lowell Observatory.  Buie's maps were generated
  345. from photometric data gathered during six years of mutual occultations of
  346. Pluto and Charon.
  347.  
  348. Venus's clouds and the textures for Ganymede, Callisto and Saturn are from
  349. Bj÷rn J≤nsson. His site at http://www.mmedia.is/~bjj/ is an excellent
  350. resource for solar system rendering.
  351.  
  352. The Io and Europa maps are by Steve Albers. His planetary maps are at:
  353.    http://laps.fsl.noaa.gov/albers/sos/sos.html
  354.  
  355. Saturn's rings were built by Grant Hutchison from Cassini imaging, with
  356. transparency information derived from stellar transit data obtained from:
  357.   http://pds-rings.arc.nasa.gov/ringocc/ringocc.html
  358.  
  359. Titan's cloud texture in natural colors and its surface map at
  360. near-infrared wavelength were created by Fridger Schrempp. They are
  361. based on resources available from the imaging site (Ciclops) of the
  362. Cassini mission,  
  363.   http://ciclops.lpl.arizona.edu/index.php
  364.  
  365. Venus's surface is a copyright-free NASA image, prepared from Magellan radar
  366. data. The original is available at 
  367.   http://www.solarviews.com/cap/venus/venmap.htm
  368.  
  369. The Earth texture was created by NASA using data from the MODIS instrument
  370. aboard the Terra satellite.  Further information is available from:
  371.   http://earthobservatory.nasa.gov/Newsroom/BlueMarble/
  372.  
  373. The textures for the Uranian satellites were created by Ivan Rivera from JPL
  374. data.  His Celestia page is: http://bruckner.homelinux.net/celestia.html
  375.  
  376. The Hyperion and Enceladus maps are photomosaics assembled by Phil Stooke and
  377. colored by Jens Meyer.
  378.  
  379. Amalthea is a shaded relief map by Phil Stooke, colored by Wm. Robert Johnston
  380. (http://www.johnstonsarchive.net/spaceart/cylmaps.html), and further modified
  381. by Jens Meyer and Grant Hutchison.
  382.  
  383. Proteus, Janus, Prometheus and Epimetheus maps are by Phil Stooke.
  384.  
  385. Dione and Rhea are USGS maps colored and modified by Jens Meyer.
  386.  
  387. Tethys is a USGS map colored and modified by Grant Hutchison.
  388.  
  389. The Moon map by Jens Meyer is based on data from PDS Map-A-Planet at
  390. http://pdsmaps.wr.usgs.gov/maps.html with colors from Mark Robinson at
  391. http://www.earth.northwestern.edu/research/robinson/MOON/clem_color.html.
  392.  
  393. The Ida and Gaspra photomosaic maps are by Phil Stooke.
  394.  
  395. The Eros map is a shaded relief generated by Grant Hutchison from the NEAR
  396. laser rangefinder shape model at:
  397.   http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape
  398.  
  399. The asteroid.jpg texture was created by Paul Roberts.
  400.  
  401. The lower resolution textures were all converted from their higher resolution
  402. versions using Gimp.
  403.  
  404. 3D asteroid models of Toutatis, Kleopatra, Geographos, 1998 KY26, Bacchus,
  405. Castalia and Golevka are courtesy of Scott Hudson, Washington State
  406. University.  His site is:
  407.   http://www.eecs.wsu.edu/~hudson/Research/Asteroids/models.html
  408.  
  409. 3D models of Phobos, Deimos, Amalthea, Janus, Epimetheus, Prometheus, Pandora,
  410. Hyperion, Larissa, Proteus, Vesta, Ida, Gaspra and Halley are derived from
  411. Phil Stooke's Cartography of Non-Spherical Worlds at:
  412.   http://publish.uwo.ca/~pjstooke/plancart.htm
  413. and optical shape model dataset at:
  414.  
  415. http://pdssbn.astro.umd.edu/SBNast/holdings/EAR-A-5-DDR-STOOKE-SHAPE-MODELS-
  416. V1.0.html
  417.  
  418. The 3D model of Eros was prepared from the NEAR laser rangefinder shape model
  419. at: http://pdssbn.astro.umd.edu/NEARdb/nlr/#shape
  420.  
  421. Grant Hutchison supplied the correct orientations for the major planets, their
  422. moons, and a number of asteroids.
  423.  
  424. Selden Ball deserves a special mention for suffering more prerelease versions
  425. finding more bugs, and giving more feedback than anyone else.
  426.  
  427. The MacOS X icon was designed by Chris Alford: http://www.chrisalford.com/
  428.  
  429. The txf font format used by Celestia was devised by Mark Kilgard.
  430.  
  431. The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
  432.  
  433. This software is based in part on the work of the Independent JPEG Group.
  434.  
  435. A special thank you goes to all Celestia users who submit bug reports,
  436. suggestions, and fixes.  Celestia wouldn't be the program it is today, without
  437. your help.
  438.  
  439.  
  440. Chris Laurel
  441.   <claurel@shatters.net>
  442.   http://www.shatters.net/~claurel/
  443.   http://www.shatters.net/celestia/
  444.